.. _cmmSxGetTargetPos:

cmmSxGetTargetPos
====================
--------------------

SYNOPSYS
`````````

.. code-block:: none

    VT_I4 cmmSxGetTargetPos(
        [in] VT_I4 Channel, [out] VT_PR8 Position
        )

        
DESCRIPTION
`````````````

- 대상 축에 대한 이송 목표 위치(상대 혹은 절대 좌표)를 반환합니다.

PARAMETER
```````````

- Channel : 축 번호. 통합 축으로 관리되는 축 번호를 의미하며, 상수 값으로 0 (Zero Based) 이상, (최대 통합 축 개수 -
  1) 이하의 값을 축 번호로 설정할 수 있습니다.

\

- Position : 이 매개변수를 통하여 대상 축에 설정된 이송 목표 위치(상대 혹은 절대 좌표)를 반환 합니다.

RETURN VALUE
`````````````

+--------------+--------------------------------+
| Value        | Meaning                        |
+==============+================================+
| 음수         | 수행 실패 또는 모션에러 발생   |
+--------------+--------------------------------+
| cmERR_NONE   | 수행 성공                      |
+--------------+--------------------------------+

EXAMPLE
`````````

.. code-block:: c++
 :linenos:
 :emphasize-lines: 5

 C/C++

 #include “Cmmsdk.h”
 #include “CmmsdkDef.h”

 void OnGetSxTargetPos ()
 {
    double fTargetPos;      // 이송 명령의 목표 위치 정보.
    double fGetPos;         // 현재 위치 정보.

    if (cmmSxGetTargetPos ( cmX1, &fTargetPos ) == cmERR_NONE )
    {
        cmmStGetPosition ( cmX1, cmCNT_COMM, &fGetPos );
        if ( fTargetPos == fGetPos )
        {
            // 단축 이송 명령에 대한 이송 완료 확인.
        }
    }
 }


.. code-block:: none
 :linenos:

 Visual Basic

 Private Sub OnGetSxTargetPos ()

    Dim fTargetPos As Double        ‘이송 명령의 목표 위치 정보.
    Dim fGetPos As Double           ‘ 현재 위치 정보.

    If cmmSxGetTargetPos ( cmX1, fTargetPos ) = cmERR_NONE Then

        Call cmmStGetPosition ( cmX1, cmCNT_COMM, fGetPos )

        If fTargetPos = fGetPos Then
            ‘ 단축 이송 명령에 대한 이송 완료 확인.
        End If
    End If

 End Sub



.. code-block:: none
 :linenos:

 Delphi

 procedure OnGetSxTargetPos ();
 var
    fTargetPos : Double; // 이송 명령의 목표 위치 정보.
    fGetPos : Double; // 현재 위치 정보.

 begin
    if cmmSxGetTargetPos ( cmX1, @fTargetPos ) = cmERR_NONE then
    begin
        cmmStGetPosition ( cmX1, cmCNT_COMM, @fGetPos );

        if fTargetPos = fGetPos then
        begin
            // 단축 이송 명령에 대한 이송 완료 확인.
        end;
    end;

 end;